My Little Realm Enterprises - Private Library 3.0 - Shareware Version ____________________________________________________________________ Important ____________________________________________________________________ Private Library is protected by copyright. It is not freeware, and it is not in the public domain. This is the Shareware (evaluation) version of My Little Realm's Private Library. It is a full-featured, fully functional program. You are welcome to try it on your computer to ensure that it functions on your system as it should, and that it meets your individual needs. If after 30 days you decide to keep using Private Library, you must pay for the program. To print an order form, press <$> in the Options Window or print the text file REGISTER.TXT. Bonus! Get one MLR stand-alone program free with every order. Read DESCRIBE.TXT for details. This offer expires 12/31/94. My Little Realm Enterprises stands behind all of its products with a 30-day money back guarantee. Thank you for trying Private Library and Shareware! ______________________________________________________________________ My Little Realm Enterprises - Private Library 3.0 - Contents General Information......................................1 Introduction........................................1 Overview.................................................1 Interface...........................................1 Quickeys............................................1 Extended Processing Options.........................2 Getting Started..........................................2 Changing the Quickeys...............................2 Creating Records....................................2 Program Information......................................3 The Options Window.......................................3 Option # 1, Adding New Records...........................3 Field Definitions...................................3 The Default Quickey Categories.................4 Hiding the Quickeys............................4 Dewey Decimal Codes............................5 Option # 2, Viewing Your Records.........................5 Option # 3, Changing the Contents of a Record............5 Option # 4, Deleting Records.............................6 Option # 5, Printing records.............................6 Option # 6, Sorting records..............................6 Option # 7, Searching Records............................7 Searching on the Title and Author Fields............7 Searching on the Category Field.....................8 Extended Processing Options..............................8 <\> Change Quickeys Categories......................8 <|> Hide/show the Quickeys..........................9 <#> Switch Between Color and B/W Modes.............10 Display EPO Symbols and Definitions............10 Private Library Page 1 ____________________________________________________________________ General Information ____________________________________________________________________ Introduction Private Library allows you to keep track of your privately owned volumes (including books, records, tapes, cd's and videos). With Private Library you can perform the standard view, edit, print and sort functions. Its most powerful feature, however, is its search function. For starters, if you'd like to see which books you have of a certain author, enter that author's name in the Search function, and you'll get every work in your library that has that name in the Author field. If you're a Sci Fi fanatic and you'd like to see what you have on robots, tell the Search function to look for "robot" in the Title field. You can also search on the Category field to see what you have in any of your current Quickey categories. Would you like a way to keep your books separate from a roommate's? Use the Category field to identify ownership. Then you can search on the Category field to see which works (or items) belong to whom. It can help keep the peace. ____________________________________________________________________ Overview Interface. Private Library's screen consists of two types of windows: a Working Window and an Options Window. If you are using a color monitor the Working Window is red and the Options Window is blue. You select processes (like adding, updating, or deleting records) in the Options Window. You create and view your records in the Working Window. ---------------------------- Quickeys. The Quickeys give you single key access to the categories you have defined in your Quickey file. Initially these are very general categories like fiction, non-fiction, etc. You can define them as you like using the <\> Change Quickeys EPO. Private Library Page 2 Extended Processing Options. Several processing tasks, called extended processing options or EPO's, are not listed in the Options Windows, because they are functions that only occasionally need to be performed. EPO's are used to "extend" a program's power and functionality. One EPO you should be aware of initially is the Change Quickeys function, which allows you to create and change your Reader and Library Quickeys. You invoke it by pressing the backslash in the Options Window. To find out what EPO commands are employed by Private Library, enter (the question mark) in the Options Window. See "Extended Processing Options", page 8, for a full description of all the EPO commands and their definitions. ____________________________________________________________________ Getting Started Changing the Quickeys. The Quickeys in Private Library let you categorize your privately owned works just the way you want. This can be by general categories like fiction, non-fiction, etc., or it could be by owner. The default categories are defined on page 4. If you'd like to see the default Quickeys of Private Library, enter the backslash key in the Options Window. This invokes the Change Quickeys function, and displays the following query in the Options Window: _______________________________________________ | | | Change which Quickey? __ | | ________________________________ | | | | | | | 1 fic 3 l/d 5 a/t | | | | 2 n/f 4 v/t 6 c/d | | | |________________________________| | | | |_______________________________________________| If you don't want to change the Quickeys at this time, simply press when you're finished studying them. If you'd like to make changes, enter the number of the Quickey category you want to change and type in the new definition. Read the section entitled "Extended Processing Options" on page 8 for more details. Creating Records. The most common items recorded in the Private Library program are books. They're easy to enter since there are only three fields to deal with: the Title field, the Author field, and the Category field. Example: Title Author Cat. Lincoln Vidal, Gore fic Private Library Page 3 Other personal collectibles that can be recorded are videos. Enter the title, as you would a book, and in the Author field, enter the time and whether the item is black & white or color. Finally, enter the Quickey (4 from the above example), v/t, for video tape. Example: Title Author Cat. Casablanca 103 min. black/white v/t After you've entered all of your video tapes, you can obtain a printed listing (to keep by the television) by invoking the Search function and searching the Category field for v/t. If you want the listing in alphabetic order, sort your records first. ____________________________________________________________________ Program Information ____________________________________________________________________ Options Window. There are seven choices in the Options Window. ________________________________________ | | | 1 Add 2 View 3 Change | | 4 Delete 5 Print 6 Sort | | 7 Search | | ---------------------------------- | | Choice __ | |________________________________________| There are several extended processing options available from the Options Window. They are detailed on page 8. ____________________________________________________________________ Option # 1, Adding New Records. The Add function in this program has three entries. To back up through the fields in this function, press the up arrow. To advance through the fields, press the down arrow. Note: You cannot use the down arrow to go from the Title field to the Author field unless the Title field has something in it. ~ Field Definitions ~ - Title field (38, required). Leading articles and prepositions should be put at the end of the title. For example, the title of the novel "The Agony and the Ecstasy" by Irving Stone would be entered as: Agony and the Ecstasy, The Private Library Page 4 - Author field (33, optional). An author's name should be entered with the last name first: Stone, Irving The major reason for entering titles and names in this manner is that it facilitates record sorting should you request that option (# 6 in the Options Window). ____________________ - Category field (3, optional). Private Library displays its built-in Quickeys when it is time to enter the category field. The Default Quickey Categories. Quickey Category Definition 1 fic fiction 2 n/f non-fiction 3 l/d laser disc 4 v/t video tape 5 a/t audio tape 6 c/d compact disc Hiding the Quickeys. Private Library only accepts a Quickey in this field. You may, on occasion, desire to enter numbers in the category field like the Dewey Decimal numbers. Rather than redefine your Category Quickey list, you can simply turn off the Quickeys. When the Quickeys are hidden, you can enter anything you like in the Category field. In other words, if the Quickeys are turned on, you are only able to enter a category from the Quickey list. If you want to enter category information that is not on the Quickey list, turn off (that is, hide) the Quickeys using the <|> EPO. You can then enter any three character string you wish. To hide the Quickeys, enter <|>, the pipe symbol on your keyboard, in the Options Window. Private Library tells you that your Quickeys are not hidden and then asks if you want to hide them. Respond , yes. If you change your mind, press or . See "Extended Processing Options" on page 8 for more details. If you should delete any of the Quickey categories, leaving the category blank, Private Library does not let you enter that Quickey in the Add or Change functions if the Quickeys are active. You can change any of the Quickeys that come with Private Library by using the backslash EPO. If you plan to use the Dewey Decimal System frequently to categorize your works, change the Quickeys to the DDS codes you'll be using most often. Private Library Page 5 -- The Dewey Decimal System Codes -- DDS Code Definition 000 General titles (journalism, bibliographies, etc.) 100 Philosophy 200 Religion 300 Social Studies 400 Languages 500 Pure Sciences 600 Technology (Applied Sciences) 700 Arts 800 Literature 900 Geography and History You can also set up your Quickeys as the initials of the realm members so that you can identify the owner of each of the works you enter in this program. To use the Change Quickey EPO, refer to the section entitled "Extended Processing Options" on page 8. Note: You cannot change the Quickeys if they are hidden. The only exception to this rule is if there are no Quickeys (i.e., you deleted all of them previously), in which case Private Library allows you to create a new Quickey list, but then your new list is considered hidden until you expressly state otherwise. If you leave Private Library with the Quickeys turned off, Private Library remembers that the next time you run the program. To show the Quickeys (i.e., turn them on), press <|> in the Options Window and reply , yes, to Private Library's query. ____________________________________________________________________ Option # 2, Viewing Your Records. Private Library asks you which record number you wish to see. You do not have to enter a record number. You can use the scrolling keys to browse through your records. Should you wish to focus on one particular entry, give the record number to Private Library and that record's information is highlighted for you. If you have a large number of records and you're trying to find a specific title or author, use the Search function, Option # 7, described on page 7. To exit the View function and return to the Options Window, press (without entering a record number) or press . ____________________________________________________________________ Option # 3, Changing the Contents of a Record. To change the contents of a record, you must first find the specific record you wish to modify. Enter the record number, and Private Library highlights the record you have selected to change. Private Library Page 6 If you select one of the fields to modify and then change your mind, press while on the input line (before you press ), and Private Library reinstates the original entry. Remember, the Title field must have an entry. You cannot leave it blank. To exit the Change function and return to the Options Window, press (without entering a record number) or press . Don't forget that if you want to change the Category field in a record and you want to use the Quickeys, they cannot be hidden. ____________________________________________________________________ Option # 4, Deleting Records. Enter the record number. Private Library highlights the entry and asks you if you are sure. You must respond for yes if you wish to effect the delete. Press , for no, or the key to cancel the delete request. Be sure the highlighted record is the one that you wish to delete. To exit the Delete function and return to the Options Window, press (without entering a record number) or press . ____________________________________________________________________ Option # 5, Printing Records. The Print function prints a listing of all of your records as they appear at the time you request the printout. Thus, if you want the records printed in sorted order, you must select option 6 first, and direct Private Library to sort the array containing your records and on which field it is to perform the sort. The Sort function then brings up the View procedure and shows you the sorted file. If all is in order, press to return to the Options Window and select 5 to print out the results of the sort. You can abort the printout at any time during the printing process by pressing . ____________________________________________________________________ Option # 6, Sorting Records. Option 6 lets you sort your records by title, author, or category. After the sorting is finished, the View function is automatically invoked and your sorted records displayed. Press to return to the Options Window. Note: Private Library stores your records on disk in the same order shown in the Viewing Window. Thus, if you've sorted your records by title, they'll be stored that way, and the next time you run Private Library, that's the order in which they'll be displayed. Private Library Page 7 ____________________________________________________________________ Option # 7, Searching Records. The Search function allows you to find all of the records with a specific character string, called a keyword, in a given field. It gives you a special look at your library, and it can help you find a specific book (or record or video) in seconds. You enter keywords without quotes. You may use the backslash as a special delimiter, described below, to force the Search function to look for external spaces. Searching on the Title and Author Fields. If you want the Search function to display all of the books with the word "computer" in the title, select the Title field from its sub-menu and enter the keyword "computer" (without the quotes). In short order, the Search function would display all of the volumes it found with the word "computer" in the title. If there is more than a screenful of records, the Search function tells you to use the scrolling keys to peruse the listing. The scrolling keys are the directional keys, + , + , , and . You can also print the Search function listing by pressing

. You must be as precise as possible if you are looking for a specific record. That is to say, if you are looking for a particular author, you must give the Search function the entire name of said author or it might retrieve a number of records whose authors have the same keyword in their names. As an example, if you were searching for all of the volumes written by "Smith, Alice", you could enter "Smith" for a keyword, but you would also get all of the records with any other Smith's you had in the Author field. You would have to enter "Smith, Alice" to have the Search function display only those works by that author. The same is true for the Title and Category fields. When you can't recall the spelling of an author's name or the title of a book (or whatever it is you've cataloged), enter just enough of the keyword to have the Search function weed out the bulk of the unwanted records. For instance, if you're trying to find a book title but all you can remember of its author's name is that it contains the syllable "Long", just enter that portion. The Search function displays the records it finds with that syllable in the Author field, like "Longman" or "Longfellow" or "Longacre", but the number of records has been reduced considerably, and you'll be able to find the record you're looking for much more quickly and easily. The Search function strips off the external blanks that you enter around a keyword when it performs the search on either the Title Private Library Page 8 field or the Author field. " ABC ", for example, is reduced to "ABC". You can force the Search function to search for precisely what you enter by delimiting your keyword with backslashes. To make the Search function look for a keyword like " ABC " (with its concomitant external spaces), you can enter: \ ABC \ Let's assume you have the following titles in your file: Longbows of the 18th Century Long John Silver Longacre's Mysteries If you simply entered "Long" at the keyword prompt, the Search function would show you all three of those records, even if you entered the keyword as "Long ". To winnow it down, you can force the Search function to search for "Long " (with a trailing space) by entering \Long \ and get only the second title, "Long John Silver". When using the backslash as a delimiter, however, you must ensure that you begin and end your keyword with backslashes. If, instead, you entered: \ long\acre the Search function assumes that it is supposed to look for the backslashes since one is embedded, and it searches for exactly what you entered ... including the backslashes. Notes: Private Library's Search function is not case sensitive, so "ABC" is the same as "aBc", and so on. Searching on the Category Field. When you search on the Category field, you must use the Quickeys if they are active. If they are inactive (hidden), you cannot use them, but you can enter any string found in the Quickey list. You simply have to key it in manually. Keywords do not have their external spaces removed when searches are performed on the Category field. So " d " (with a space on either side) is different from "d " (with two trailing spaces), and so on. ____________________________________________________________________ Extended Processing Options EPO Definition <\> Change Quickeys Categories. The Quickeys categories can be up to three letters long, and are used to describe the categories of your personal volumes. Private Library comes with six Quickey classi- fications that represent general purpose categories. Private Library Page 9 Default Quickeys. ________________________________ | | | 1 fic 3 l/d 5 a/t | | 2 n/f 4 v/t 6 c/d | |________________________________| Quickey Code Definition 1 fic fiction 2 n/f non-fiction 3 l/d laser disc 4 v/t video tape 5 a/t audio tape 6 c/d compact disc You can, of course, change any you choose. For example, you could make one of your categories "Com" for comic books or "BBC" for baseball cards. You can even use the initials of the owners of the works you are cataloging as a means of identifying ownership, should you wish to keep your works separate from your roommate's. You do not need to use the Quickeys. For example, while the Quickeys are active, you must either use a Quickey or press to leave the Category field blank. If you want to be able to enter any random numbers or letters in the Category field, use the <|> EPO, described below, to hide the Quickeys. Then you can enter whatever you wish. Note: You cannot change the Quickeys if they are hidden. <|> Hide/show the Quickeys. The Quickeys are numbers one through six in the first position of the category entry. Enter <|> in the Options Window and Private Library tells you if your Quickeys are hidden or not. It then asks you if you want to reverse the situation. If the Quickeys are turned on, you must use them when you are entering data in the Category field. If you want to enter categories not found in your Quickey list, you must either turn off the Quickeys or change the current Quickeys. If you turn off the Quickeys, you can enter anything you wish in the three character field. You do no harm to your previously entered records by turning the Quickeys on and off. - - - - - - - - - Private Library Page 10 <+> Print a Listing of a Specific Category. Note: This EPO is no longer supported in Version 2.x. See the Search function, option <7> in the Options Window, for this and many other new features found in Version 2.x and later. - - - - - - - - - <#> Switch between color and B/W modes. - - - - - - - - - Display the EPO's used in this Program. ____________________________________________________________________ + The End + ____________________________________________________________________ (c) Copyright 1991 - 1994 John L. Salisbury